<!DOCTYPE html>
<html lang="zh">
	<head>
		<meta charset="utf-8" />
		<base href="../../../" />
		<script src="page.js"></script>
		<link type="text/css" rel="stylesheet" href="page.css" />
	</head>
	<body>
		<h1>[name]</h1>

		<p class="desc">表示三次球面谐波(SH)。光照探测器使用此类来编码光照信息。</p>

		<h2>构造函数(Constructor)</h2>
		<h3>[name]()</h3>
		<p>
			创建[name]的新实例。
		</p>

		<h2>特性(Properties)</h2>

		<h3>[property:Array coefficients]</h3>
		<p>包含(9)个SH系数的数组。单个系数表示为[page:Vector3 Vector3]的实例。</p>

		<h3>[property:Boolean isSphericalHarmonics3]</h3>
		<p>
			用于检查给定对象是否为SphericalHarmonics3类型的只读标志。
		</p>

		<h2>Methods</h2>

		<h3>[method:SphericalHarmonics3 add]( [param:SphericalHarmonics3 sh] )</h3>
		<p>
			[page:SphericalHarmonics3 sh] - 要添加的SH。<br /><br />

			将给定的 SH 添加到此实例。
		</p>

		<h3>[method:SphericalHarmonics3 addScaledSH]( [param:SphericalHarmonics3 sh], [param:Number scale] )</h3>
		<p>
			[page:SphericalHarmonics3 sh] - 要添加的SH。<br />
			[page:Number scale] - 比例因子。<br /><br />
			一次 执行[page:.add]()和[page:.scale]()的便捷方法。
		</p>

		<h3>[method:SphericalHarmonics3 clone]()</h3>
		<p>
			返回具有相等系数的[name]的新实例。
		</p>

		<h3>[method:SphericalHarmonics3 copy]( [param:SphericalHarmonics3 sh] )</h3>
		<p>
			[page:SphericalHarmonics3 sh] - 要复制的SH。<br /><br />

			将给定的SH复制到此实例。
		</p>

		<h3>[method:Boolean equals]( [param:SphericalHarmonics3 sh] )</h3>
		<p>
			[page:SphericalHarmonics3 sh] - 要与之比较的 SH。<br /><br />

			如果给定的SH和此实例具有相等的系数，则返回true。
		</p>

		<h3>[method:SphericalHarmonics3 fromArray]( [param:Array array], [param:Number offset] )</h3>
		<p>
			[page:Array array] - 保存SH系数数的数组。<br />
			[page:Number offset] - （可选）数组偏移量。<br /><br />

			从给定数组设置此实例的系数。
		</p>

		<h3>[method:Vector3 getAt]( [param:Vector3 normal], [param:Vector3 target] )</h3>
		<p>
			[page:Vector3 normal] - 法向量（假定为单位长度）。<br />
			[page:Vector3 target] - 结果向量。<br /><br />

			返回给定法线方向的辐射度。
		</p>

		<h3>[method:Vector3 getIrradianceAt]( [param:Vector3 normal], [param:Vector3 target] )</h3>
		<p>
			[page:Vector3 normal] - 法向量（假定为单位长度）。<br />
			[page:Vector3 target] - 结果向量。<br /><br />

			返回给定法线方向的辐照度（辐射度与余弦波瓣卷积）。
		</p>

		<h3>[method:SphericalHarmonics3 lerp]( [param:SphericalHarmonics3 sh], [param:Number alpha] )</h3>
		<p>
			[page:SphericalHarmonics3 sh] - 要插入的SH。<br />
			[page:Number alpha] - alpha因子。<br /><br />

			通过给定的alpha因子在给定的SH和此实例之间进行线性插值。
		</p>

		<h3>[method:SphericalHarmonics3 scale]( [param:Number scale] )</h3>
		<p>
			[page:Number sh] - 比例因子。<br /><br />

			按给定的比例因子缩放此SH。
		</p>

		<h3>[method:SphericalHarmonics3 set]( [param:Array coefficients] )</h3>
		<p>
			[page:Array coefficients] - 一组SH系数。<br /><br />

			将给定的SH系数设置为此实例。
		</p>

		<h3>[method:Array toArray]( [param:Array array], [param:Number offset] )</h3>
		<p>
			[page:Array array] - （可选）目标数组。<br />
			[page:Number offset] - （可选）数组偏移量。<br /><br />

			返回包含系数的数组，或将它们复制到提供的数组中。系数表示为数字。
		</p>

		<h3>[method:SphericalHarmonics3 zero]()</h3>
		<p>
			将所有SH系数设置为0。
		</p>

		<h2>静态方法(Static Methods)</h2>

		<h3>[method:undefined getBasisAt]( [param:Vector3 normal], [param:Array shBasis] )</h3>
		<p>
			[page:Vector3 normal] - 法向量（假定为单位长度）。<br />
			[page:Array shBasis] - 生成的SH基础。<br /><br />

			计算给定法向量的 SH 基础。
		</p>

		<h2>源代码(Source)</h2>

		<p>
			[link:https://github.com/mrdoob/three.js/blob/master/src/[path].js src/[path].js]
		</p>
	</body>
</html>
